Walkthrough

Adds fast-symlink detection and optimized readlink behavior; extends test image creation with a symlink.txt and updates tests to assert its target; routes test error output to stderr; removes per-file pyright import-cycle directives and centralizes the setting in pyproject.toml; bumps version to 1.3.1.

Changes

Sequence Diagram

sequenceDiagram
    participant Caller
    participant SymbolicLink
    participant Inode
    participant Volume

    Caller->>SymbolicLink: readlink()
    SymbolicLink->>SymbolicLink: is_fast_symlink?
    alt Fast symlink
        SymbolicLink->>Volume: seek(offset + Inode.i_block.offset)
        Volume-->>SymbolicLink: read i_size bytes (symlink target)
    else Non-fast symlink
        SymbolicLink->>Inode: _open()
        Inode->>Volume: read via filesystem mechanisms
        Volume-->>Inode: file contents
        Inode-->>SymbolicLink: return content
    end
    SymbolicLink-->>Caller: return target bytes

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• Unify test image creation logic #9: Adds symlink creation and test workflow changes for the test image; closely related to the test harness and symlink assertions in this PR.

Poem

🐰 I hopped into the inode light,

Found symlinks tucked compact and tight.
Quick reads now from blocks I sweep,
Tests confirm the target keep.
A tiny hop, a version nudge — delight!

❌ Failed checks (1 warning)

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

• X
• Mastodon
• Reddit
• LinkedIn